/* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil; -*- */
/* vim:set et sts=4: */
/* IBust - IBus with Traditional interface
 * Copyright(c) 2013 Daniel Sun
 * Copyright (C) 2008-2010 Peng Huang <shawn.p.huang@gmail.com>
 * Copyright (C) 2008-2010 Red Hat, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#if !defined (__IBUST_H_INSIDE__) && !defined (IBUST_COMPILATION)
#error "Only <ibust.h> can be included directly"
#endif

/**
 * SECTION: ibustconfigservice
 * @short_description: Configuration service back-end.
 * @stability: Stable
 *
 * An IBustConfigService is a base class for other configuration services such as GConf.
 * Currently, directly known sub class is IBustConfigGConf.
 *
 * IBustConfigServiceClass has following member functions:
 * <itemizedlist>
 *     <listitem>
 *         <para>gboolean set_value(IBustConfigService *config, const gchar *section, const gchar *name,
 *             const GValue *value, IBustError **error)
 *         </para>
 *         <variablelist>
 *             <varlistentry>
 *                 <term>config:</term>
 *                 <listitem>A configure service</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>section:</term>
 *                 <listitem>Section name of the configuration option.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>name:</term>
 *                 <listitem>Name of the configuration option.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>value:</term>
 *                 <listitem>GValue that holds the value.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>error:</term>
 *                 <listitem>Error outputs here.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>Returns:</term>
 *                 <listitem>TRUE if succeed; FALSE otherwise.</listitem>
 *             </varlistentry>
 *         </variablelist>
 *         <para>Set a value to a configuration option.
 *         </para>
 *     </listitem>
 *     <listitem>
 *         <para>gboolean get_value(IBustConfigService *config, const gchar *section, const gchar *name,
 *             GValue *value, IBustError **error)
 *         </para>
 *         <variablelist>
 *             <varlistentry>
 *                 <term>config:</term>
 *                 <listitem>A configure service</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>section:</term>
 *                 <listitem>Section name of the configuration option.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>name:</term>
 *                 <listitem>Name of the configuration option.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>value:</term>
 *                 <listitem>GValue that holds the value.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>error:</term>
 *                 <listitem>Error outputs here.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>Returns:</term>
 *                 <listitem>TRUE if succeed; FALSE otherwise.</listitem>
*             </varlistentry>
*         </variablelist>
 *        <para>Get value of a configuration option.
 *        </para>
 *     </listitem>
 *     <listitem>
 *         <para>gboolean unset(IBustConfigService *config, const gchar *section, const gchar *name,
 *             IBustError **error)
 *         </para>
 *         <variablelist>
 *             <varlistentry>
 *                 <term>config:</term>
 *                 <listitem>A configure service</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>section:</term>
 *                 <listitem>Section name of the configuration option.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>name:</term>
 *                 <listitem>Name of the configuration option.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>error:</term>
 *                 <listitem>Error outputs here.</listitem>
 *             </varlistentry>
 *             <varlistentry>
 *                 <term>Returns:</term>
 *                 <listitem>TRUE if succeed; FALSE otherwise.</listitem>
 *             </varlistentry>
 *         </variablelist>
 *         <para>Remove an entry to a configuration option.
 *         </para>
 *     </listitem>
 * </itemizedlist>
 */
#ifndef __IBUST_CONFIG_SERVICE_H_
#define __IBUST_CONFIG_SERVICE_H_

#include "ibustservice.h"

/*
 * Type macros.
 */

/* define GOBJECT macros */
#define IBUST_TYPE_CONFIG_SERVICE             \
    (ibust_config_service_get_type ())
#define IBUST_CONFIG_SERVICE(obj)             \
    (G_TYPE_CHECK_INSTANCE_CAST ((obj), IBUST_TYPE_CONFIG_SERVICE, IBustConfigService))
#define IBUST_CONFIG_SERVICE_CLASS(klass)     \
    (G_TYPE_CHECK_CLASS_CAST ((klass), IBUST_TYPE_CONFIG_SERVICE, IBustConfigServiceClass))
#define IBUST_IS_CONFIG_SERVICE(obj)          \
    (G_TYPE_CHECK_INSTANCE_TYPE ((obj), IBUST_TYPE_CONFIG_SERVICE))
#define IBUST_IS_CONFIG_SERVICE_CLASS(klass)  \
    (G_TYPE_CHECK_CLASS_TYPE ((klass), IBUST_TYPE_CONFIG_SERVICE))
#define IBUST_CONFIG_SERVICE_GET_CLASS(obj)   \
    (G_TYPE_INSTANCE_GET_CLASS ((obj), IBUST_TYPE_CONFIG_SERVICE, IBustConfigServiceClass))

G_BEGIN_DECLS

typedef struct _IBustConfigService IBustConfigService;
typedef struct _IBustConfigServiceClass IBustConfigServiceClass;

/**
 * IBustConfigService:
 *
 * An opaque data type representing a configure service.
 */
struct _IBustConfigService {
    /*< private >*/
    IBustService parent;
    /* IBustConfigServicePriv *priv */

    /* instance members */
};

struct _IBustConfigServiceClass {
    /*< private >*/
    IBustServiceClass parent;

    /*< public >*/
    /* class members */
    gboolean    (* set_value)   (IBustConfigService    *config,
                                 const gchar          *section,
                                 const gchar          *name,
                                 GVariant             *value,
                                 GError              **error);
    /**
     * get_value:
     * @config: An IBustConfig.
     * @section: section name
     * @name: value name
     *
     * @returns: (transfer full): The value in config associated with section and name.
     *
     */
    GVariant *  (* get_value)   (IBustConfigService    *config,
                                 const gchar          *section,
                                 const gchar          *name,
                                 GError              **error);
    gboolean    (* unset_value) (IBustConfigService    *config,
                                 const gchar          *section,
                                 const gchar          *name,
                                 GError              **error);
    GVariant *  (* get_values)  (IBustConfigService    *config,
                                 const gchar          *section,
                                 GError              **error);

    /*< private >*/
    /* padding */
    gpointer pdummy[12];
};

GType                ibust_config_service_get_type   (void);

/**
 * ibust_config_service_new:
 * @connection: An GDBusConnection.
 * @returns: A newly allocated IBustConfigServices.
 *
 * New an IBustConfigService from an GDBusConnection.
 */
IBustConfigService   *ibust_config_service_new        (GDBusConnection     *connection);

/**
 * ibust_config_service_value_changed:
 * @config: An IBustConfigService.
 * @section: Section name of the configuration option.
 * @name: Name of the configure option.
 * @value: GVariant that holds the value.
 *
 * Change a value of a configuration option
 * by sending a "ValueChanged" message to IBust service.
 */
void                 ibust_config_service_value_changed
                                                    (IBustConfigService  *config,
                                                     const gchar        *section,
                                                     const gchar        *name,
                                                     GVariant           *value);

G_END_DECLS
#endif

